KotOR DeNCS Script Decompiler
Authors:
	JdNoa - Script Decompiler - jdnoa@hotmail.com
	Dashus - GUI - humanitas@gmail.com

---------------
Version
---------------
Beta 1 - May 21 2005

---------------
Description.
---------------
DeNCS is an internal tool used by TSLRP (The Sith Lords Restoration Project).  It is being released to the public "as is".  There is no warranty, implicit or explicit, of any kind.

At present the decompiler will only work with KotOR2:TSL scripts.

---------------
Installation
---------------
Requirements:
	JRE 1.6.0: This program requires the Java JRE 1.6.0.  At the time of this readme the only location from which this version of the JDK (which includes the JRE; the JRE is not yet available separately) may be downloaded is http://www.java.net/download/jdk6/binaries/
	KotorTool(referred to as KT): The uber program for all KotOR modding.  The download provides nwnnsscomp.exe.  Available from http://kotortool.home.comcast.net/
	nwscript.nss: This comes with KotOR2 (and KotOR, but use the KotOR2 version).  Open KT and expand the follow tree path: Kotor II -> BIFs -> scripts.bif -> Script, Source .  Then scroll down to nwscript.nss, select it and hit 'Extract file' and save it to your KT directory.

Simply extract this zip to the KT directory.  NOTE: this program will only work with nwnnsscomp provided by KT.  It will VERY LIKELY FAIL with any other version.

---------------
Uninstallation
---------------
Simply delete the jar file, nwscript.nss, and dencs.conf

---------------
Using DeNCS
---------------
On first run you will be presented with a prompt to set the output directory for nss files.  This can be changed later by going to the "Options" menu item and choosing "Settings".

Decompiling:
	To decompile ncs scripts use the "Open" command in the "File" menu (shortcut: Ctrl-O) or drag the desired ncs files onto the right pane.

Closing files:
	Hit the X on the corresponding tab or select "Close" from the "File" menu (shortcut: Ctrl-W).  If the decompiled file has been modified not been saved the program will ask if you would like to save the deocmpiled file (as an nss).

Changing the file:
	Recompilation of the file will occur on either renaming of variables or function as well as saving a modified file.  If this fails the output from nwnnsscomp will be available in the status pane 	at the bottom of the program window.
	Renaming variables or functions:
		Single click on the corresponding name in the tree view on the left side.  After waiting 1-2 seconds single click again and edit the value.  Hit enter when done.
		WARNING: renaming variables or functions regenerates the code, which will overwrite your manual changes.
	Editing the decompiled script:
		Simply edit the text in the decompiled file view.
		WARNING: renaming variables or functions regenerates the code, which will overwrite your manual changes.
	Editing the byte code:
		Byte code editing is not available (nor will ever be).

Switching between Decompiled View and Byte Code View:
	Right click on the text area and select the top-most option to switch to the other view.

Link Scroll Bars:
	This option links the scroll bars in byte code view so that moving one scroll bar will cause the other to move as well.  The text area with the longest text area will be set to have it's scroll bar as the "master".  The other will not function while Link Scroll Bars is enabled.
	To enable Linked Scroll Bars right click while in Byte Code View and click on "Link Scroll Bars".  Disabling may be done in the same manner.

Memory management:
	We recommend keeping an eye on the amount of memory DeNCS uses.  It builds some very large internal data structures.  You may want to quit and restart DeNCS after decompiling many files, or any particularly large files.

---------------
Future versions
---------------
At some point there may be future revisions to this program.  These would likely come after the release of TSLRP if at all.  The first features which would be added are better memory management, K1 support and NSS file opening/editing w/ compilation.